home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / prog / rukq10.zip / MODAC1.DOC < prev    next >
Text File  |  1993-02-15  |  16KB  |  371 lines

  1. MODAC Copyright 1993 by Cornel Huth. All Rights Reserved.
  2. MODAC1.EXE, 31-Jan-1993.
  3.  
  4.  
  5.       MODAC. A shareware mod file player and digital VOC and WAVE file
  6.       player/recorder. Continued use requires registration of $15, US
  7.       DOLLARS ON US BANK. No Credit Cards. Pre-paid orders only. US
  8.       Currency accepted for foreign orders.
  9.  
  10.       MODAC was written using my RUCKUS-DAC, with Mod extensions, sound library.
  11.       Also available is RUCKUS-MIDI. The graphics is done with my QB/EVGFX,
  12.       level 2, graphics library. The compiler used was Microsoft BASIC 7.1.
  13.       The sound and graphics libraries are shareware, available for download
  14.       on my BBS.
  15.  
  16.       The latest version Modac, and my other shareware products, may be
  17.       downloaded from The Fortieth Floor BBS, 1(210)684-8065. 16 hours
  18.       of operation: 17:00 to 09:00 Central Time.
  19.  
  20.       Minimum Requirements:
  21.  
  22.               IBM PC or compatible
  23.               256K RAM
  24.               DOS 3.0+
  25.               VGA
  26.  
  27.               Note: See the Additional Notes at the end of this document.
  28.  
  29.       PC speaker can be used, as can an LPT-DAC on the first LPT port,
  30.       the Disney Sound Source, the AdLib, the Sound Blaster and the
  31.       Sound Blaster Pro. Recording requires either of the Sound Blasters.
  32.  
  33.       Additional Recommendation:
  34.  
  35.               IBM AT or compatible (for mod file playback, a 386/25+)
  36.               1MB extended RAM
  37.               XMS 2.0 (3.0+ required for XMS use under 386 memory managers)
  38.               Mouse
  39.               Sound Blaster Pro sound card
  40.  
  41.  
  42.       Incompatibilities:
  43.  
  44.       Use of DOSMAX has been demonstrated to affect performance by as
  45.       much as 50% in mod file playback. 386 memory managers have no
  46.       noticable effect.
  47.  
  48.       Tandy 2000-series computers may have an incompatible timer chip.
  49.       DMA-only operations should not be affected.
  50.  
  51.       -- This software was developed on an Intel 486/33, Symphony chipset,
  52.       using the Sound Blaster Pro, and a Tseng VGA card w/ET4000AX.
  53.  
  54.       Bus-based mouse should not be using a Microsoft MOUSE.xxx driver in
  55.       the version 7.xx. Use 6.xx or the 8.xx versions.
  56.  
  57.       Some 386 and 486 machines are unable to play Mod data when using both
  58.       DMA and BG modes. Neither of my two machines are affected by this,
  59.       but be aware that some machines will lock up when DMA+BG is used for
  60.       mod file playback.
  61.  
  62.       Performance:
  63.  
  64.       Varies, depending on machine. DMA mode offers good across-the-board
  65.       sound performance on VOC/WAVE data, regardless of CPU power. For
  66.       TIMER-0 operation, the more CPU power, the better. AdLib digital
  67.       output demands lots of CPU power.
  68.  
  69.       For mod processing, the best performance is achieved with foreground
  70.       processing (BG disabled) and DMA processing. 45.5kHz processing rate
  71.       is possible with a 486/33 and an SBPro. With DMA-BG processing, 40kHz
  72.       is about it for a 486/33. In stereo, a mod process rate of 22.75kHz
  73.       is no problem for a 486. If you've never heard a mod played in stereo
  74.       using Modac and an SBPRO, you just haven't heard a mod played.
  75.  
  76.       You should be aware that over-taxing the machine when playing a
  77.       mod may lock your machine up. Use the CPU RESERVES: status in the
  78.       NOSCOPE scope window. If it doesn't say OKAY, you are over-taxing
  79.       your system.
  80.  
  81.       The AdLib output level may be rather low so turn up your volume.
  82.       For mod playback you should limit the rate to no more than 10kHz.
  83.       13kHz tops.
  84.  
  85.  
  86.       BASIC INFO -----------------------------------------------------
  87.  
  88.       At start-up, Modac scans for sound devices. The highest numbered
  89.       device is the device that Modac uses by default. Modac knows
  90.       about the following devices:
  91.  
  92.               0-PC speaker (PCSPK0 at startup)
  93.               1-LPT-DAC
  94.               2-Disney Sound Source
  95.               3-Adlib (ADLIB0 at startup)
  96.               4-Sound Blaster
  97.               5-Sound Blaster Pro
  98.  
  99.       Note that the LPT-DAC is found if there is a parallel printer
  100.       port, even if no DAC is hooked up to it.
  101.  
  102.       All PCs have the PC speaker device. Modac has two PC speaker
  103.       drivers. PCSPK0 is the default. PCSPK1 up-samples and offers a better
  104.       quality sound than PCSPK0. Use Ctrl-S to toggle between the two
  105.       when the device is selected. Ctrl-S also toggles the ADLIB0/ADLIB1
  106.       mode. Do not use the -1 versions to playback voc/wave files that are
  107.       already at a high sample rate (over 8kHz or so). The -1 versions
  108.       are for voc/wave playback; there is no difference when playing mods.
  109.  
  110.  
  111.       The AdLib is a very slow device for doing digital output. It can
  112.       be done but for best results (as far as the AdLib goes), a fast
  113.       CPU is desired. When using ADLIB1, make sure that the original
  114.       sample is no greater than 8kHz. After loading the VOC/WAV file,
  115.       adjust the desired sample rate so that it is slightly less than
  116.       the actual files sample rate. In some cases ADLIB1 can simply not
  117.       be used. Use ADLIB0 mode if you have too much trouble with ADLIB1.
  118.  
  119.  
  120.       Modac down-samples where required so even the PC speaker can
  121.       play a 44kHz stereo WAV file, for example. Adjust the interrupt
  122.       rate in the STATUS BOARD to approximate the desired rate. Modac
  123.       makes on-the-fly adjustments to meet the desired rate. For PCSPK1,
  124.       set the sample rate equal to the actual file sample rate. The
  125.       result will be a 2x up-sample for remarkably clear sound. To
  126.       have the SB (non-PRO) play stereo or high-rate samples, you must
  127.       use timer-0 mode.
  128.  
  129.       ------------------------------------------------------------------
  130.       Note: To adjust a rate with the mouse, use the LEFT MOUSE BUTTON
  131.       to decrease, and the RIGHT MOUSE BUTTON to increase. In the case
  132.       of adjusting the sample rate, each click results in a 100Hz change.
  133.       For 1000Hz changes, press CTRL while clicking, or for finer
  134.       adjustments, hold down the ALT key while clicking. BG must be enabled
  135.       for adjustments to be made while playing. If you click the right
  136.       mouse button on a volume/level control, all related sliders are
  137.       set to that position.
  138.       ------------------------------------------------------------------
  139.  
  140.       For overriding Modac defaults or using Modac without a mouse, see
  141.       section II. COMMAND-LINE OPTIONS.
  142.  
  143.       Device Select.
  144.  
  145.       Available devices are in low-green. Unavailable are low-red. The
  146.       currently selected device is in hi-green.
  147.  
  148.            Note: The AdLib card is a supported device in Modac. It is
  149.            also supported in the CHIMPS program. CHIMPS is similar to
  150.            Modac, except that it plays MIDI files (General MIDI, MT-32,
  151.            and CMF).
  152.  
  153.       To change the current device, click on its button. If the PCSPK or
  154.       ADLIB is currently selected, you can use Ctrl-S to switch between
  155.       the two playback modes available.
  156.  
  157.  
  158.       File Select.
  159.  
  160.       Modac starts up in DIGITAL file mode. The file manager scans for
  161.       all *.VOC or *.WAV files in the current directory. To load a
  162.       file, click on its name in the FILE MANAGER window. Use the
  163.       up/down buttons to scroll through the file list.
  164.  
  165.       To change file modes, go to the STATUS BOARD and click on the
  166.       file mode button until MOD is displayed.
  167.  
  168.       To change directories, click on the desired directory name.  To
  169.       move back to the parent directory, click on the .. entry.
  170.  
  171.       To move to another drive, click on the drive's letter to the
  172.       right of the file entries.
  173.  
  174.       Foreground/Background Play Mode.
  175.  
  176.       Before playing, you may want to select background play by click-
  177.       ing on BG in the SPECIAL FUNCTION BOARD. If BG is not selected,
  178.       all computer resources are spent playing. To exit foreground
  179.       play, press Ctrl-Alt.
  180.  
  181.       BG has the advantage of letting you perform other tasks while the
  182.       playing takes place. You can scan through directories, looking
  183.       for what to play next or select one of the various scope meters
  184.       to give the audio a visual accompaniment. You can also adjust
  185.       volume, filters, playback rate, etc.
  186.  
  187.  
  188.       Play.
  189.  
  190.       To play the loaded file, click on the PLAY button in the STATUS
  191.       BOARD.
  192.  
  193.  
  194.       Stop.
  195.  
  196.       To stop play, click on the STOP button or press the Esc key.
  197.  
  198.  
  199.       Exit Modac to DOS.
  200.  
  201.       To end the program and return to DOS, press Alt-X or click on the
  202.       EXIT button at the lower-right of the display.
  203.  
  204.  
  205.       DOS ENVIRONMENT VARIABLE & COMMAND-LINE OPTIONS ---------------------
  206.  
  207.       Modac uses the DOS variable MODAC=. To have Modac start up in a
  208.       certain state, you can set this variable to your values. Command-line
  209.       options take precedence over the MODAC environment variable states.
  210.  
  211.       For example:
  212.  
  213.               SET MODAC=FILE:*.MOD BG SR:44
  214.  
  215.       has Modac start up in mod file mode, background processing, and
  216.       a process rate of 44kHz (de-rated to 22kHz if stereo is selected--
  217.       the default mode of the SBPRO). You can use a command-line option
  218.       to override this, say, by using a sr:32 on the command line.
  219.  
  220.       Example command line:
  221.  
  222.               C>modac file:daisychn.mod sr:32 color:67
  223.  
  224.       To override some of Modac's defaults, you can use the following
  225.       options:
  226.  
  227.       FILE:file.ext
  228.  
  229.            Load file.ext and play. Also switches Modac file mode to
  230.            .ext. File must reside in current drive\directory. 8-bit VOC
  231.            or .WAV files are supported, up to 45.5kHz, mono and stereo.
  232.  
  233.       BG
  234.  
  235.            Start up in background play mode.
  236.  
  237.       SR:nn
  238.  
  239.            Set sample rate in kHz. For example, use 22 for 22kHz. For
  240.            stereo playback of FILE:file.ext on the SBPRO, double the
  241.            value. E.g., to play DAISYCHN.MOD in stereo at 22kHz, use SR:44.
  242.  
  243.       DMAX:nn
  244.  
  245.            Sets the startup mod file DMA background buffer fill slice count.
  246.            Higher numbers devote more processing time to the buffer fill
  247.            routine. This may be beneficial to slower machines. On fast
  248.            machines the default value of 1 should be just fine. Setting the
  249.            value too high may cause the time-of-day clock to loose time.
  250.            The max value for DMAX:nn is 64. This value should be set to
  251.            1 if BG is not enalbled. DMAX: only affects mod file processing.
  252.            If DMAX is set 64-99 then DMAX is set to 512.
  253.  
  254.       DEVICE:n
  255.  
  256.            Select startup device. Device must be installed. Devices are:
  257.  
  258.                       0-PC speaker
  259.                       1-LPT-DAC on first parallel printer port
  260.                       2-Disney Sound Source
  261.                       3-AdLib
  262.                       4-Sound Blaster (1.03 or above)
  263.                       5-Sound Blaster Pro
  264.  
  265.       COLOR:hh
  266.  
  267.            Alter Modac color scheme. The first h is for the underlying
  268.            screen color; the second for the board foreground. h is a
  269.            hex value, 0-F. The default scheme is COLOR:67.
  270.  
  271.       NoUMB
  272.  
  273.            Prevent Modac from using UMB memory for storing some mod
  274.            file data. If DOS=,UMB is in CONFIG.SYS, Modac uses as much
  275.            UMB memory for mod file data as it can.
  276.  
  277.       muSBP
  278.  
  279.            For Sound Blaster emulation of the SB PRO's mixer facility
  280.            and data display.
  281.  
  282.       KEY:
  283.  
  284.            Unlocks advanced save feature to save recordings made by
  285.            Modac. Also performs format translation. You can load a
  286.            .WAVfile and save it in .VOC format, or vice versa.
  287.  
  288.  
  289.       CONTROLLING MODAC --------------------------------------------------
  290.  
  291.                                  The L-R MOD switches  The FAST MOD is for
  292.                                  left/right output     slow PCs attempting
  293.                                  channels on stereo    to play mod files.
  294.                                  mod output.           Click to toggle state.
  295.  
  296. ┌──────────────────────────────────────────────────────────────┬─────┬─────
  297. │ DEVICE BOARD  Device selection is made here.                 │L-R  │FAST
  298. └──────────────────────────────────────────────────────────────┴─────┴─────
  299. ┌─────┐┌──────────────────────────────────┐┌─────────────────────────
  300. │ S F ││  CONTROL BOARD                   ││  STATUS BOARD
  301. │ P U ││                                  ││
  302. │ E N ││ In VOC/WAV mode, this board      ││ Various Modac states are set
  303. │ C C ││ controls volumes and SBPRO mixer ││ here. With the SB, you can use
  304. │ I T ││ levels, filters, input source,   ││ DMA or TIMER-0. XMS memory needs
  305. │ A I ││ and record mode (stereo/mono).   ││ DMA mode. Memory used/reming is
  306. │ L O ││                                  ││ shown, as is timer-0 priority,
  307. │   N ││ In mod mode, it controls volumes,││ scope mode, running clock, file
  308. │ B   ││ DMA buffer size, output filter,  ││ mode, interrupt process rate,
  309. │ O   ││ and stereo/mono output mode.     ││ CPU stats and more.
  310. │ A   ││                                  ││
  311. │ R   ││ The lamp at the lower-right is   ││
  312. │ D   ││ red when the SB speaker is on.   ││
  313. └─────┘└──────────────────────────────────┘└─────────────────────────
  314. ┌────────────────────────────┐┌──────────────────────────────────────
  315. │ FILE MANAGER               ││ SCOPE
  316. │ ┌────────────────────────┐ ││
  317. │ │Z:\CURRENT\FILE.VOC     │ ││  Various scopes are available. Scopes
  318. │ └────────────────────────┘ ││  operate only if BG is enabled, or if DMA
  319. │ ┌─┐┌────────────┐          ││  processing and not in mod file mode.
  320. │ ├─┤│FILE.VOC    │  Drives  ││
  321. │ │e││..          │          ││  Not all scopes are available for all devices
  322. │ │r││MOREDIR\    │ A  B  C  ││  in all modes. SBPRO has all scopes available
  323. │ │r││OTHER\      │          ││  when in DMA mode.
  324. │ │o││WAVS\       │ D  E  F  ││
  325. │ │r││ Click on file/dir     ││
  326. │ │ ││ entry to load or move ││
  327. │ ├─┤│ to new directory.     ││
  328. │ └─┘└───                    ││
  329. └────────────────────────────┘└──────────────────────────────────────────
  330. ┌─────────────────────────────────────────────────────────────────────────
  331. │ INFO WINDOW  Messages/error messages
  332. └──────────────────────────────────────────────────────────────────────────
  333.  
  334.  
  335.       TIPS:
  336.  
  337.       When recording using the Sound Blaster or Pro, the SB speaker output
  338.       should be off. This is automatically done by Modac when recording
  339.       starts. However, if you adjust the Main Volume, the SB speaker
  340.       is set on. To turn it off, turn the Main Volume to 0.
  341.  
  342.       When RECORD is selected, all available memory is allocated for
  343.       the recording. You may stop recording at any point. To clear
  344.       memory, press the SCANSOFT button in the SPECIAL FUNCTION BOARD.
  345.  
  346.       The PRIORITY window in the STATUS BOARD may be set to 2 to disable
  347.       normal BIOS clock updating and gives all background time to the
  348.       RUCKUS digital processing code. Setting the PRIOR to 0 is not
  349.       recommended.
  350.  
  351.       The mod DMA 4/8/16K buffer size gives good results at 4 with a fast
  352.       machine. Larger buffer sizes makes the VUMETER bars out-of-sync
  353.       since the VU meters respond to the mod data currently being processed,
  354.       while the sound playing is coming from buffered data. The slower the
  355.       rate the more noticable the effect. For slow machines and higher mod
  356.       processing rates, a larger buffer makes for a smoother sound.
  357.  
  358.  
  359. Additional Notes.
  360.  
  361. Modac.exe has also been tested on a 286 machine using a mono video system.
  362. It works. No UI is available; you need a VGA for that. But you can use the
  363. CL options and have Modac operate as a foreground task. To play a file on a
  364. mono system, do:
  365.  
  366.         C>modac FILE:filename.ext SR:16
  367.  
  368. To end playback early, press Ctrl-Alt. Otherwise, the tune plays until it's
  369. over.
  370.  
  371.